home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / lr20.zip / LSTRELAY.DOC < prev    next >
Text File  |  1991-09-13  |  10KB  |  255 lines
  1.                   ┌──────────────────────────────────────┐
  2.                   │             LSTRELAY                 │
  3.                   │      Exhibit A Communications        │
  4.                   │ 110 East Avenida Palizada, Suite 201 │
  5.                   │       San Clemente, CA 92672         │
  6.                   │      InfoMat BBS (714)492-8727       │
  7.                   └──────────────────────────────────────┘
  8. ┌─────────────┐
  9. │ Description │
  10. └─────────────┘
  11.  
  12. LSTRELAY is a PCRelay utility that enables sysops to automate the
  13. generation of news files announcing time and date of last PCRelay
  14. transfer.  The LSTRELAY utility allows the sysop to select either one
  15. screen design, or let the program select a different one each day.
  16.  
  17. LSTRELAY will also import a private message to the sysop in the main
  18. forum message base of the BBS.  This message will provide information
  19. regarding the status of the last mail run.  Sysop will be informed of
  20. the number of messages imported, number of messages exported, name of
  21. files requested/sent and other information collected from PCRelay's
  22. log file.
  23.  
  24. ┌──────────────────┐
  25. │ Copyright Notice │
  26. └──────────────────┘
  27.  
  28. LSTRELAY is being distributed as shareware.  While it may be freely
  29. distributed, no charge may be extracted for such distribution with the
  30. following exceptions: User groups, Pay BBSes, or software distributors.
  31. In any case, no more than $6.00 may be charged for
  32. duplication/distribution of this file.
  33.  
  34. LSTRELAY was created by Michael J. Gibbs for Exhibit A Communications.
  35. Individual screens were designed by individuals listed at the end of
  36. this document.  This program is the copyrighted work of Exhibit A
  37. Communications, 1991.
  38.  
  39.  
  40. ┌────────────┐
  41. │ Disclaimer │
  42. └────────────┘
  43.  
  44. While every effort has been made to ensure the safety of this program,
  45. neither Exhibit A Communications nor Michael J. Gibbs may be held liable
  46. for any damage caused to hardware, software, reputation, goodwill or karma
  47. through the use of this program.  Use of LSTRELAY is an indication that you
  48. understand this disclaimer.
  49.  
  50.  
  51. ┌──────────────┐
  52. │ Registration │
  53. └──────────────┘
  54.  
  55. Running a BBS, I am on a tight budget much as you are.  As such, I have
  56. tried to structure the registration fee to cover this.  The payment
  57. options are as follows:
  58.         1) Send money ($10.00 US would be good)
  59.         2) Send registered programs you have written, preferably ones
  60.            that will work with a GAP BBS
  61.         3) Send ANSI screens to include in program
  62.  
  63. Registration will grant you support for this program, as well as remove
  64. the beg screen from the relay report imported to the BBS's message base.
  65.  
  66. To register, please print out ORDER.FRM, fill it out and mail it.  It's
  67. that simple.
  68.  
  69.  
  70. ┌───────┐
  71. │ Usage │
  72. └───────┘
  73.  
  74. Requirements
  75. ───────────
  76.  
  77. LSTRELAY requires the following:
  78.         IBM compatible personal computer (PC, XT, AT, 386, etc.)
  79.         DOS 3.0 or higher
  80.         BBS software with supporting UTIs (available from BBS developer)
  81.         Running PCRelay networking software.
  82.  
  83.  
  84. Installation
  85. ────────────
  86.  
  87. The only files necessary to running LSTRELAY are LSTRELAY.EXE and
  88. it's configuration file.  They can be copied to any directory that you
  89. wish.  Registered versions require the file REG.FIL be placed in same
  90. directory as LSTRELAY.EXE.
  91.  
  92. NOTE: If you are running a version of PCRELAY that doesn't require
  93. the use of UTIs, (like some PCBOARD users), you will need to get the
  94. correct UTIIMPRT.EXE AND UTIHIGH.EXE for your BBS software.
  95.  
  96. If you are relaying with more than one network, you may have a
  97. copy of the configuration file for each network.  This will give you a
  98. last relay screen for each one.  In order to prevent any confusion, you
  99. might want to rename each configuration file to reflect the network that
  100. it is for.
  101.  
  102. SPECIAL NOTE:  If you are running only one network relay, it is probably
  103. best to leave the configuration file name LSTRELAY.CFG.  Beta tester
  104. Krause reported that PCRelay will erase the configuration file if you
  105. name it the same as your net id (ie: id = BUILDERS, file named
  106. BUILDERS.CFG) and if it is placed in the same directory as your PCRelay
  107. files.
  108.  
  109.  
  110. Configuration
  111. ─────────────
  112.  
  113. The configuration file should only be edited with a text editor like
  114. EDLIN, QEDIT or any word processor that can save ASCII or DOS files
  115. (Wordstar or WordPerfect).  Before using LSTRELAY, you must change
  116. configuration file to reflect your particular set up.
  117.  
  118. The configuration file allows you to make comments in the file by
  119. placing a semicolon (;) in the first position on each line.
  120.  
  121. There are seven lines that you must complete before you can use LSTRELAY.
  122. The order of the information is most important.  If you wish, you may
  123. remove the comment lines, but I would keep them as it makes it easier to
  124. track down problems.
  125.         1) screen number to use
  126.         2) color screen type
  127.         3) bbs name
  128.         4) network name
  129.         5) name of file created by PCRelay (relay.log)
  130.         6) name of the ASCII news file for your BBS to use
  131.         7) name of the ANSI News file for your BBS to use
  132.  
  133. 1) Screen Number
  134.         This line should contain the number of the screen that you wish
  135.         to have generated.  If you use the digit zero (0), the program
  136.         will rotate through the available displays.
  137.  
  138. 2) Color Screen type
  139.         This line will determine what type of color screen is generated.
  140.                 A       will create an ANSI screen
  141.                 X       will create an Xcode screen
  142.                 G       will create a GAP-specific Xcode screen
  143.         Regardless of what is entered on this line, when in local mode
  144.         (see Operation below) the ANSI screen will be sent to screen.
  145.  
  146. 3) BBS Name
  147.         This line should contain the name of your BBS as you wish it to
  148.         be shown on the news screens.  This line must be less than 24
  149.         characters in length.
  150.  
  151. 4) Network Name
  152.         This line should contain the name of the network that you are
  153.         relaying as you want it to be shown on the news screens.  This
  154.         line must be less than 24 characters in length.
  155.  
  156. 5) Name of signal file created by PCRelay
  157.         This line should contain the full path/filename of the file
  158.         created by the network software where transfer information
  159.         is logged.  Normally called RELAY.LOG.
  160.  
  161. 6) name of ASCII news file for your BBS to use
  162.         This line should contain the full path/filename of the ASCII
  163.         news file announcing time of last transfer.  This feature should
  164.         allow LSTRELAY to work with any BBS that uses news files.
  165.  
  166. 7) Name of ANSI news file
  167.         This line should contain the full path/filename of the ANSI news
  168.         file announcing the time of last transfer.  If your BBS doesn't
  169.         use ANSI codes to color screens, contact me at the BBS listed at
  170.         the top of these documents and we can come up with a solution.
  171.  
  172. Operation
  173. ─────────
  174.  
  175. LSTRELAY is run by simply placing the line:
  176.         LSTRELAY [switches] (config.file)
  177. in your batch file (event file) after running PCRelay's Import program.
  178. (config.file) is the full path/filename of LSTRELAY's configuration
  179. file.  If LSTRELAY is not located in the current directory or a
  180. directory listed in your path statement in AUTOEXEC.BAT, the you will
  181. have to precede LSTRELAY with the full drive\path.  LSTRELAY will do the
  182. rest.
  183.  
  184. Switches are allowed on command line for modification of program operation.
  185. A switch must start with a forward slash '/' and will be followed by
  186. one or two letter/numbers.  The are:
  187.         Switch          Effect
  188.         /NI             Will prevent LSTRELAY from importing message to
  189.                         BBS's message base.
  190.         /NS             Will prevent LSTRELAY from creating news screens.
  191.         /X#             Will cause LSTRELAY to not use screen # if you
  192.                         have configured program to use a rotating selection
  193.                         of screens.  Only one program may currently be
  194.                         excluded at a time.
  195.         /#              On-screen preview. See below.
  196.         /F#             Allows sysop to specify forum number (#) where report
  197.                         is to be imported.
  198.  
  199. While LSTRELAY is designed to be operated from within a batch file, you
  200. may also run it from the command line.  A switch on the command line
  201. allows you to preview what any given screen will look like using your
  202. configuration.  The command line looks like this:
  203.         LSTRELAY /# (config.file)
  204. where config.file is the path\filename of your configuration file and #
  205. is a number from 0 to the maximum number of screens available.  If you
  206. choose a number higher than the maximum screen number available in the
  207. current release it will tell you.  If you use 0, it will cycle through
  208. all available screens.
  209.  
  210.  
  211. Problems
  212. ────────
  213.  
  214. LSTRELAY will create an error log (LSTRELAY.ERR) in the directory where
  215. the .EXE file is located.  Any errors that occur while not in local mode
  216. will be logged to this file.  The file may be deleted at any time, since
  217. program will create a new one if needed.
  218.  
  219.  
  220. ┌─────────┐
  221. │ Support │
  222. └─────────┘
  223.  
  224. I will provide support to registered users of this program through
  225. InfoMat BBS, CompuServe Information Service or over the Intelec network.
  226.  
  227.         InfoMat BBS (714) 492-8727              checked daily
  228.         CIS #72246,1653                         checked whenever
  229.         Intelec node ID  ->EXHIBITA
  230.         MediaNET node ID ->EXHIBITA
  231.  
  232.  
  233. ┌────────────────┐
  234. │ Special Thanks │
  235. └────────────────┘
  236.  
  237. Of course no program would be complete without a thanks to those who
  238. provided assistance in creating the final product.  A big special thanks
  239. goes out to:
  240.  
  241. Timothy Krause, Sysop of Builders Board (714) 361-5150
  242.         Tim provided invaluable Beta testing and advice along the way.
  243.         Give his board a call, and express your undying gratitude to him
  244.         <g>.
  245.  
  246. And also to Beta Testers:
  247.         Dave Safely, Sysop of System III BBS (714) 830-1884
  248.         Brett Martin, Sysop of Calypso BBS   (714) 492-1045
  249.  
  250.  
  251.                         SCREENS DESIGNED BY:
  252.         6       Calypso BBS, Brett Martin.  (714) 492-1045
  253.  
  254.         7 & 8   Builders Board, Timothy Krause (714) 361-5150
  255.